CodeServer on Docker

Introduction

English | 简体中文

This repository is an Cloud Native solution powered by Websoft9, it simplifies the complicated installation and initialization process.

System Requirements

The following are the minimal recommended requirements:

• OS: Red Hat, CentOS, Debian, Ubuntu or other's Linux OS
• Public Cloud: More than 20+ major Cloud such as AWS, Azure, Google Cloud, Alibaba Cloud, HUAWEIClOUD, Tencent Cloud
• Private Cloud: KVM, VMware, VirtualBox, OpenStack
• ARCH: Linux x86-64, ARM 32/64, Windows x86-64, IBM POWER8, x86/i686
• RAM: 2 GB or more
• CPU: 1 cores or higher
• HDD: at least 20 GB of free space
• Swap file: at least 2 GB
• bandwidth: more fluent experience over 100M

QuickStart

All-in-one Installer

Use SSH to connect your instance and run the automatic installation script below

sudo wget -N https://raw.githubusercontent.com/Websoft9/docker-template/main/docker-installer.sh; sudo bash docker-installer.sh -r codeserver

package install

1.Make package You can get the package as following script

sudo wget -N https://raw.githubusercontent.com/Websoft9/docker-template/main/docker-installer.sh; sudo bash docker-installer.sh -r codeserver -p

2.Install by package Copy package to your server, Use SSH to connect your instance and run the automatic installation script below

sudo bash install-codeserver

Manual Installation

Preparation

If you have not install Docker and Docker-Compose, refer to the following commands to install it:

curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.sh
curl -L "https://github.com/docker/compose/releases/download/1.29.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
ln -sf /usr/local/bin/docker-compose  /usr/bin
sudo systemctl start docker

Install CodeServer

We assume that you are already familiar with Docker, and you can modify docker-compose file by yourself

git clone --depth=1 https://github.com/Websoft9/docker-codeserver
cd docker-codeserver
docker-compose -f docker-compose-production.yml  --env-file  .env_all up -d

FAQ

Do I need to change the password before docker-compose up?

Yes, you should modify all database password and application password at docker-compose file for production

Docker runing failed for the reason that port conflict?

You should modify ports at docker-compose file and docker-compose again

Usage instructions

You can point your browser to: http://Instance's Internet IP:9001

The following is the information that may be needed during use

Credentials

By default, the available users are:

Username	Password
nothing	123456

Services and Ports

Service	Port	Use	Necessity
codeserver	9001	Web-GUI Vscode management tool	Y

Documentation

CodeServer Administrator Guide

Enterprise Support

If you want to get our Enterprise Support to ensure high availability of applications, you can subscribe our CodeServer Enterprise Support

What you get with a Enterprise Support subscription?

• Knowledge: Answers and guidance from product experts
• Support: Everything you need for technical support, e.g Enable HTTPS, Upgrade guide
• Security: Security services and tools to protect your software