1
0
Fork
You've already forked testnet
0
A Docker-based virtual network for testing software which communicates using HTTPS.
  • Nix 84.4%
  • Shell 13.3%
  • Makefile 2.3%
2026年06月16日 13:32:42 +01:00
apps Add cron job 2026年06月16日 13:32:42 +01:00
etc Add mechanism for mocking DNS replies 2025年02月21日 16:04:16 +00:00
tools Proxy URL should use http:// instead of https:// 2025年04月19日 11:53:57 +01:00
.gitignore Add Maildev 2024年10月13日 09:55:15 +01:00
.gitmodules Add Hubzilla 2026年06月15日 09:51:58 +01:00
docker-compose.yml Switch to a more recent dnsmasq image 2025年11月16日 10:57:05 +00:00
README.md Add README.md 2024年08月21日 16:46:47 +01:00

Test Network

This repository offers you the .test TLD, an isolated network on which applications can communicate with one another using HTTPS, just as though they were using the real Internet.

It is capable of running complex applications such as Mastodon and Hubzilla.

Setting up the network

Clone this repository:

$ git clone https://codeberg.org/FenTiger/testnet
$ cd testnet

Run the setup script to create a Docker network and a root certificate. You only need to do this once:

$ ./tools/setup.sh

Note that this script also saves some settings in .env. You'll need the contents of this file to add applications to the network.

Finally, start the network:

$ docker compose up

Setting up a web browser

Create a new browser profile and change the following settings:

  • Proxy server - set this to https://127.0.0.1:53081, or use a different IP address if appropriate
  • Root certificate - the setup.sh script placed this in ./etc/ca/certs/root_ca.crt. Configure your browser to trust this certificate.

Now you should be able to view the Traefik dashboard at:

https://dashboard.test/

If you can see this page - you're ready to add real software to the network.

Credits

Traces of Sandcastles are still visible in places, where the incoming tide hasn't quite washed them away.