# Getting started

## About

This workspace has browser-based VS-Code version, full-screen terminal, file manager, and task scheduler. 
You can code, upload and dowload files and schedule periodic executios of scripts and jobs.  

Workspace is based on the Ubuntu 20 docker image, with common CLI applications, such as Git, Vim, Nano and curl installed.

## Quicklaunch

From the quicklaunch page you can open workspace tools, such as code editor or terminal 

<div align="center" style="font-style: italic;">
    Demo: Workspace UI 
</div>

<p align="center">
  <img src="https://raw.githubusercontent.com/bluxmit/alnoda-workspaces/main/workspaces/ide-workspace/img/wid-ui.png" alt="wid-ui.png" width="750">
</p>

## Code Editor

Code editor is a browser-based open-source Visual Studio Code. It is fast, responsive, and full-featured. It features code highlighting, 
autocompletion, rendering of notebooks has a tree-based file browser, and a great number of pre-installed color themes.  

<p align="center">
  <img src="https://raw.githubusercontent.com/bluxmit/alnoda-workspaces/main/workspaces/ide-workspace/img/theia-themes.png" alt="theia-themes.png" width="750">
</p>

You can install any extension from [open-vsx.org](https://open-vsx.org/) that has hundreeds of extensions for VS Code compatible editors. 


<p align="center">
  <img src="https://raw.githubusercontent.com/bluxmit/alnoda-workspaces/main/workspaces/ide-workspace/img/theia.gif" alt="Theia demo" width="750">
</p>

## Terminal

Workspace has full-size browser-base terminal

<p align="center">
  <img src="https://raw.githubusercontent.com/bluxmit/alnoda-workspaces/main/workspaces/base-workspace/img/base-workspace-terminal.gif" alt="Base-Workspace terminal" width="750">
</p> 

## Scheduler

Cronicle can execute on schedule scripts, jobs and tasks. It has nice UI to monitor executions and failures

<p align="center">
  <img src="https://raw.githubusercontent.com/bluxmit/alnoda-workspaces/main/workspaces/ide-workspace/img/cronicle.gif" alt="Cronicle" width="750">
</p>

## Install applications

Open workspace terminal to install new applications. 
Simply execute `apt install` with `sudo`.  

For example, install emacs 

```sh
sudo apt-get install emacs
```

If you want to install PHP, execute

```sh
sudo add-apt-repository ppa:ondrej/php
sudo apt-get update
sudo apt-get install php8.1
```

## Python
Python and Pip are installed. Execute `python3` in terminal.  

To install python packages use PIP

```
pip install pandas
```

## Node.js
Use Nodeenv to create Node.js environments.  

For example, open workspace terminal, create folder npmgui, and activate environment with node v.12.18.3 and npm v.6.0.0

```
cd /home
mkdir npmgui; cd npmgui  
nodeenv --node=12.18.3 --npm=6.0.0 env
```

Let's install package and start node application, explicitly on port 8040

```
. env/bin/activate && npm i -g npm-gui   
npm-gui 0.0.0.0:8040
```

In the Quicklaunch go to the tab 'My apps' and open app on the port 8040. 

> **NOTE:** If you close terminal, the application will stop. If you want application to keep running after workspace terminal is closed 
start it with **"&!"** at the end. 

## Keep services runnning

Any application started in the terminal will run as long as your terminal session is alive. 
If you want any application or service runing after terminal session is closed, start service with **"&!"** at the end of 
the command.  

For example, to start *npm-gui* and keep it running after terminal is closed, run 

```
npm-gui 0.0.0.0:8040 &!
```