uccnetsoc/netsocadmin2 repository overview

⁠Netsoc Admin

⁠Purpose

This is intended to be a one-stop shop for users of UCC Netsoc's servers.

⁠Features

⁠We have

• Automated user account creation
• MySQL database managment
• Backup managment
• Server password reset functionality
• Facility to contact a sysadmin
• WordPress installer
• Tutorials
• Change your login shell

⁠We will have

• Own domain name linking to WordPress installation
• Slide upload page
• And more

⁠Installation

⁠For developing locally, please look further below

To build the docker image:

1. Create a netsocadmin/config.py following the same format as of that in netsocadmin/config.py. This file configures the netsoc admin server itself.
2. In this directory, run the following for a non development image:

docker build -t docker.netsoc.co/netsoc/netsocadmin .

To run the docker image:

docker run \
    -d -p 5050:5050 \
    --name netsocadmin \
    -v /path/to/backups:/backups \
    -v /path/to/home/dirs:/home/users \
    -v /path/to/admin_passwords.py:/netsocadmin/config.py \
    docker.netsoc.co/netsocadmin:latest

⁠Developer Environment

Please checkout our Netsoc Developer Environment⁠

⁠Note

Just to be aware that testing on MacOS might require you to build the netsocadmin docker image locally to test it, due to some issues with crypt functions on MacOS. I don't know why it's a thing, but it is :(

1. docker build -t netsocadmin .
2. docker run -d -p 5050:5050 --name netsocadmin --net host netsocadmin
3. Connect to localhost:5050 and continue as normal