_____ _ _ _ ____
| ___| __ ___ ___| |_ ____ | \ | |/ ___|
| |_ | '__/ _ \/ _ \ __|_ /____| \| | | _
| _|| | | __/ __/ |_ / /_____| |\ | |_| |
|_| |_| \___|\___|\__/___| |_| \_|\____|
Freetz-NG is a fork of Freetz. More features - less bugs!
- A web interface will be started on port :81, credentials:
admin
/freetz
- Default credentials for shell/ssh/telnet access are:
root
/freetz
- For more see: freetz-ng.github.io
- You need an up to date Linux System with some prerequisites.
- Or download a ready-to-use VM like Gismotro's Freetz-Linux (user & pass:
freetz
). - There are also Docker images available like pfichtner-freetz (README).
git clone https://github.com/Freetz-NG/freetz-ng ~/freetz-ng
Or clone a single tag:
git clone https://github.com/Freetz-NG/freetz-ng ~/freetz-ng --single-branch --branch TAGNAME
cd ~/freetz-ng
tools/prerequisites install # -y
cd ~/freetz-ng
make menuconfig
make
# make help
cd ~/freetz-ng
tools/push_firmware -h
git status
git diff --no-prefix # --cached # > file.patch
git log --graph # --oneline
git checkout master ; git fetch --all --prune ; git reset --hard origin/HEAD ; git clean -fd
git pull
git checkout HASH-OF-COMMIT # -b NEW-BRANCH
git checkout EXISTING-BRANCH
git clone https://gitlab.com/Freetz-NG/freetz-ng ~/freetz-ng
git clone https://bitbucket.org/Freetz-NG/freetz-ng ~/freetz-ng
See https://freetz-ng.github.io/ (or docs/).
Testing your Documentation changes localy
When working on this repo, it is advised that you review your changes locally before committing them. The mkdocs serve
command can be used to live preview your changes (as you type) on your local machine.
Please make sure you fork the repo and change the clone URL in the example below for your fork:
-
Linux Mint / Ubuntu 20.04 LTS / 23.10 and later:
- Preparations (only required once):
git clone https://github.com/YOUR-USERNAME/freetz-ng cd freetz-ng sudo apt install python3-pip python3-venv python3 -m venv .venv source .venv/bin/activate pip3 install -r .github/mkdocs/requirements.txt
- Enter the virtual environment (if exited):
source .venv/bin/activate
- Running the docs server:
mkdocs serve --dev-addr 0.0.0.0:8000
-
Fedora Linux instructions (tested on Fedora Linux 28):
- Preparations (only required once):
git clone https://github.com/YOUR-USERNAME/freetz-ng cd freetz-ng pip install --user -r .github/mkdocs/requirements.txt
- Running the docs server:
mkdocs serve --dev-addr 0.0.0.0:8000
After these commands, the current branch is accessible through your favorite browser at http://localhost:8000