Docker Installing

Requirement Environment​

• Docker
• Modern browser

Install Steps​

The flow of installation is based on Centos7.x.

1. Install docker​

WARNING

if you have installed docker, you can skip this step.

The following steps are for Centos, please refer to Docker Official Document for other systems.

yum install -y yum-utils
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum install docker-ce docker-compose-plugin
systemctl enable docker
systemctl start docker

2. Create docker-compose.yml​

vi docker-compose.yml

version: "3.3"
services:
  db:
    image: mariadb:10.8.2
    container_name: spug-db
    restart: always
    command: --port 3306 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    volumes:
      - /data/spug/mysql:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=spug
      - MYSQL_USER=spug
      - MYSQL_PASSWORD=spug.cc
      - MYSQL_ROOT_PASSWORD=spug.cc
  spug:
    image: openspug/spug-service
    container_name: spug
    privileged: true
    restart: always
    volumes:
      - /data/spug/service:/data/spug
      - /data/spug/repos:/data/repos
    ports:
      # if port 80 is occupied, you can replace it with other ports, such as: - "8000:80"
      - "80:80"
    environment:
      - MYSQL_DATABASE=spug
      - MYSQL_USER=spug
      - MYSQL_PASSWORD=spug.cc
      - MYSQL_HOST=db
      - MYSQL_PORT=3306
    depends_on:
      - db

3. Start container​

docker compose up -d

WARNING

docker-compose install method is different, you may also need to execute docker-compose up -d

4. Initialization​

The following operation will create an administrator account with the user name admin and password spug.dev, you can replace the administrator account/password by yourself.

docker exec spug init_spug admin spug.dev

5. Access test​

Enter http://localhost:80 in the browser to access (the default account password is set in step 4).

6. Version upgrade​

You can view the current running Spug version in System Management/System Settings/About, you can view the current latest version in Update Log, if you need to upgrade Spug, please refer to Version Upgrade Document.