Welcome to the IPFire Wiki

This wiki is a community-maintained resource about everything there is to know about IPFire. Join us and help us improving it!

Looking for something?

Use the search and find answers to everything about IPFire. If you cannot find what you are looking for, join our community and talk to fellow IPFire users, developers and everybody else involved in the project.

IPFire Community

Differences in Revisions: Serial Console

Older Revision
July 15 at 9:16 pm
Remove extra backslash
# Serial Console
IPFire can be configured using a serial console - which is a common way to configure network hardware like switches and firewalls. For that, a serial cable is required. Since modern computers no longer come with a serial port, a USB-to-serial adapter can be used as well.
Connect your firewall with the serial cable and your computer first and then power it on.
## Linux
On any Linux-based computer, you can use `screen` to connect to the serial console. The command is:
`sudo screen /dev/ttyUSB0 115200`
115200 is the default baud rate for IPFire. `/dev/ttyUSB0` is most likely the device node for a USB-to-serial adapter. If you are using an actual serial port on your computer, this would be `/dev/ttyS0`.
You can leave `screen` by typing Ctrl-A K.
## Windows
[PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) is a great tool to connect to a serial console. Start it, select "Serial" as connection type and enter your serial interface as well as the baud rate of 115200. Most likely your serial interface will be called `COM3`.
## macOS
There are a number of [good tools](https://pbxbook.com/other/mac-ser.html) to connect to a serial console. [Serial](https://decisivetactics.com/products/serial/) is one of the better tools and can be downloaded directly from its website or via [Mac App Store - Serial](https://apps.apple.com/app/serial/id877615577)
Depending on the USB-to-serial adapter, a driver may need to be installed on the Mac. Information about the adapter should include a reference to the needed driver.
Launch the Serial app and in the Open Port window pick the adapter (in my case it is CP2102). Go to the menu Terminal > Settings and set the baud rate to 115200.