Add an important note about mapping the ssh port on the container to the host
|8 years ago|
|s6||8 years ago|
|README.md||8 years ago|
|build.sh||8 years ago|
|nsswitch.conf||8 years ago|
|sshd_config||8 years ago|
|start.sh||8 years ago|
Docker for Gogs
To keep your data out of Docker container, we do a volume(
/data) here, and you can change it based on your situation.
# Pull image from Docker Hub. $ docker pull gogs/gogs # Create local directory for volume. $ mkdir -p /var/gogs # Use `docker run` for the first time. $ docker run --name=gogs -p 10022:22 -p 10080:3000 -v /var/gogs:/data gogs/gogs # Use `docker start` if you have stopped it. $ docker start gogs
Note: It is important to map the Gogs ssh service from the container to the host and set the appropriate SSH Port and URI settings when setting up Gogs for the first time. To access and clone Gogs Git repositories with the above configuration you would use:
git clone ssh://git@hostname:10022/username/myrepo.git for example.
Files will be store in local path
/var/gogs in my case.
/var/gogs keeps Git repositories and Gogs data:
/var/gogs |-- git | |-- gogs-repositories |-- ssh | |-- # ssh public/private keys for Gogs |-- gogs |-- conf |-- data |-- log
Volume with data container
If you're more comfortable with mounting data to a data container, the commands you execute at the first time will look like as follows:
# Create data container docker run --name=gogs-data --entrypoint /bin/true gogs/gogs # Use `docker run` for the first time. docker run --name=gogs --volumes-from gogs-data -p 10022:22 -p 10080:3000 gogs/gogs
Using Docker 1.9 Volume command
# Create docker volume. $ docker volume create --name gogs-data # Use `docker run` for the first time. $ docker run --name=gogs -p 10022:22 -p 10080:3000 -v gogs-data:/data gogs/gogs
Most of settings are obvious and easy to understand, but there are some settings can be confusing by running Gogs inside Docker:
- Repository Root Path: keep it as default value
start.shalready made a symbolic link for you.
- Run User: keep it as default value
start.shalready setup a user with name
- Domain: fill in with Docker container IP(e.g.
192.168.99.100). But if you want to access your Gogs instance from a different physical machine, please fill in with the hostname or IP address of the Docker host machine.
- SSH Port: Use the exposed port from Docker container. For example, your SSH server listens on
22inside Docker, but you expose it by
10022:22, then use
10022for this value. Builtin SSH server is not recommended inside Docker Container
- HTTP Port: Use port you want Gogs to listen on inside Docker container. For example, your Gogs listens on
3000inside Docker, and you expose it by
10080:3000, but you still use
3000for this value.
- Application URL: Use combination of Domain and exposed HTTP Port values(e.g.
Full documentation of settings can be found here.
❗❗❗Make sure you have volumed data to somewhere outside Docker container❗❗❗
Steps to upgrade Gogs with Docker:
docker pull gogs/gogs
docker stop gogs
docker rm gogs
- Finally, create container as the first time and don't forget to do same volume and port mapping.
.dockerignoreseems to be ignored during Docker Hub Automated build