Repository files navigation

Run Linux Desktop on Web for FREE -KASM Workspace on OracleCloud -Ampere A1 Compute Instance.

1. Create an Account in Oracle Cloud. SeeOracle Always Free Services.
2. To create ARM Instance, referthis documentation.
3. To Launch a Linux Instance in OracleCloud, referthis documentation.
4. Open ports 80 and 443 to allow HTTP Traffic. Referopening-up-port
5. InstallDocker in Ubuntu.
6. Note down the Public IP Address of the instance - say140.240.180.210

Note:

While the above pre-requisite is given to setup a Linux Instance in Oracle Cloud ARM instance, this setup will work inother cloud providers like AWS, GCP, Azure as well.

Simply create a Linux Instance, install Docker and open HTTP Ports.
Make sure to select an instance type with sufficient RAM and CPU to run multiple Linux Desktops.

1. Create an account inhttps://desec.io

2. Create a new DomainYOUR_DOMAIN.dedyn.io underhttps://desec.io/domains - Example:apps.dedyn.io

3. Add multiple A records inYOUR_DOMAIN.dedyn.io and point to the Public IP Address of the instance.

   Type	Subname	IP Address	TTL (seconds)	Comments
   A	(blank)	140.240.180.210	3600	points toYOUR_DOMAIN.dedyn.io
   A	*	140.240.180.210	3600	points to*.YOUR_DOMAIN.dedyn.io
   A	docker	140.240.180.210	3600	points todocker.YOUR_DOMAIN.dedyn.io
   A	installer	140.240.180.210	3600	points toinstaller.YOUR_DOMAIN.dedyn.io
   A	proxy	140.240.180.210	3600	points toproxy.YOUR_DOMAIN.dedyn.io

   Note: For some reason the wildcard is not working and all other subname/subdomain had to be explicitly added.

4. Create and note down the DESEC Token underhttps://desec.io/tokens - sayYOUR_DESEC_TOKEN_STRING

git clone git@github.com:RawSanj/kasm-cloud-workspace.git&&cd kasm-cloud-workspace

# Set desec.io token created in Step 1.4export DESEC_TOKEN="YOUR_DESEC_TOKEN_STRING"# Set Traefik Credentials:export TRAEFIK_CREDENTIALS=$(htpasswd -nbB admin"SuperSecretPassword")# Set WORKING_DIR to point to cloned repo directory:export WORKING_DIR="/path/to/kasm-cloud-workspace"

1. Edit traefik/traefik.yml and setYOUR_DOMAIN.dedyn.io inentryPoints.websecure.http.tls.domains section and email for certificate expiry notifications fromLet's Encrypt

   # Run below command to replace exiting domain with your domainsed -i's/apps.dedyn.io/YOUR_DOMAIN.dedyn.io/g' traefik/traefik.yml# Run below command to replace exiting email with your emailsed -i's/ADD_EMAIL@gmail.com/YOUR_EMAIL@example.com/g' traefik/traefik.yml

2. Edit traefik/config.yml and setYOUR_DOMAIN.dedyn.io intls.stores.default.defaultGeneratedCert.domains section.

   # Run below command to replace exiting domain with your domainsed -i's/apps.dedyn.io/YOUR_DOMAIN.dedyn.io/g' traefik/config.yml

1. Start Docker Containers:

   docker-compose up -d

   1. When running this for the first time, docker will download all the images and start all the containers.
   2. Traefik Proxy will start the provisioning of Certificates usingDNS-01 Challenge to enable automatic HTTPS viaLet's Encrypt.
2. Install and RunKASM:
   1. Visithttps://installer.YOUR_DOMAIN.dedyn.io to setup KASM credentials and Workspaces. You can add more Workspaces later via Admin UI.
   2. This will download several Docker Containers used by KASM and the Workspaces Containers in Docker-in-Docker mode.
   3. Once installation is completed, visithttps://kasm.YOUR_DOMAIN.dedyn.io and login to start using KASM Workspaces.

Visithttps://docker.YOUR_DOMAIN.dedyn.io to start managing and deploying docker containers.