---
title: "Username Password"
slug: "fmadio-os-authentication-username-password"
updated: 2026-06-30T11:25:30Z
published: 2026-06-30T11:25:30Z
canonical: "docs.fmad.io/fmadio-os-authentication-username-password"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fmad.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Username Password

## Web GUI

FMADIO Packet Capture Systems use the default login and password when the system is shipped. Additional WebGUI users can be added manually using the FMADIOCLI utility. To set a new password "password" for the fmadio account use the following command line:

### Step 1) Create new user

```plaintext
fmadiocli "config userlist add <username>"
```

Reference: [fmadiocli config userlist add](https://docs.fmad.io/docs/config-userlist#config-userlist-add)

Example output of adding username “bob”

```plaintext
fmadio@fmadio100v2-228U:~$ fmadiocli "config userlist add bob"
[Sun Apr 20 17:59:19 2025] CmdLine [config userlist add bob]
[Sun Apr 20 17:59:19 2025] Cmd [config userlist add bob ]
[Sun Apr 20 17:59:19 2025] Created new User [bob]
fmadio@fmadio100v2-228U:~$
```

### Step 2) Set password

Set the password for the new user, bob to test1234. Use the command below

```plaintext
fmadiocli "config userlist password <user> <password>"
```

Reference: [fmadiocli config userlist password](https://docs.fmad.io/docs/config-userlist#config-userlist-password)

Example output shown below

```plaintext
fmadio@fmadio100v2-228U:~$ fmadiocli "config userlist password bob test1234"
[Sun Apr 20 17:59:49 2025] CmdLine [config userlist password bob test1234]
[Sun Apr 20 17:59:49 2025] Cmd [config userlist password bob test1234 ]
fmadio@fmadio100v2-228U:~$
```

### Step 3) Set permissions

Set the permission level for the new user, use the command below

```plaintext
fmadiocli "config userlist permission <username> <permission>"
```

Reference: [fmadiocli config userlist permission](https://docs.fmad.io/docs/config-userlist#config-userlist-permission)

Example shows setting bob to full user access

```plaintext
fmadio@fmadio100v2-228U:~$ fmadiocli "config userlist permission bob full"
[Sun Apr 20 18:01:48 2025] CmdLine [config userlist permission bob full]
[Sun Apr 20 18:01:48 2025] Cmd [config userlist permission bob full ]
[Sun Apr 20 18:01:48 2025] modified username [bob] to permission level [full]
fmadio@fmadio100v2-228U:~$
```

### Step 4) Verify

To verify the current userlist and permission use

```plaintext
fmadiocli "show userlist"
```

Reference: [fmadiocli show userlist](https://docs.fmad.io/docs/config-userlist#show-userlist)

Example shows the currently configured users

```plaintext
fmadio@fmadio100v2-228U:~$ fmadiocli "show userlist"
[Sun Apr 20 18:04:54 2025] CmdLine [show userlist]
[Sun Apr 20 18:04:54 2025] Cmd [show userlist ]
[Sun Apr 20 18:04:54 2025] Showing User List
[Sun Apr 20 18:04:54 2025]
[Sun Apr 20 18:04:54 2025] UserList Enable: true
[Sun Apr 20 18:04:54 2025]
[Sun Apr 20 18:04:54 2025] --------------------------------------------------
[Sun Apr 20 18:04:54 2025]
[Sun Apr 20 18:04:54 2025]   UserName   : testuser
[Sun Apr 20 18:04:54 2025]   Permission : user
[Sun Apr 20 18:04:54 2025]   SecBPF     :
[Sun Apr 20 18:04:54 2025]
[Sun Apr 20 18:04:54 2025]   UserName   : bob
[Sun Apr 20 18:04:54 2025]   Permission : full
[Sun Apr 20 18:04:54 2025]   SecBPF     :
[Sun Apr 20 18:04:54 2025]
[Sun Apr 20 18:04:54 2025]   UserName   : userlevel
[Sun Apr 20 18:04:54 2025]   Permission : user
[Sun Apr 20 18:04:54 2025]   SecBPF     :
[Sun Apr 20 18:04:54 2025]
[Sun Apr 20 18:04:54 2025]   UserName   : fmadio
[Sun Apr 20 18:04:54 2025]   Permission : full
[Sun Apr 20 18:04:54 2025]   SecBPF     :
[Sun Apr 20 18:04:54 2025]
[Sun Apr 20 18:04:54 2025] --------------------------------------------------
fmadio@fmadio100v2-228U:~$
```

## SSH

Unfortunately adding additional SSH usernames is not possible. However using Active Directory, or LDAP, or RADIUS multiple different users can login to the system with administrator privileges.

If centerlaized authentication is not possible, multiple people can login to the system using different SSH keys via the .authorized_keys config file.

The authorized ssh keys file is located in

Copy

```plaintext
/opt/fmadio/etc/fmadio_authorized_keys
```

Please note, the authorized_keys file in the users .ssh account directory does not persist across reboots. Keys must be added to the above location.

### Change SSH Password

Changing the default SSH password uses the standard linux utilit "passwd".

### Step 1) update the password

Using passwd util change the fmadio user password per below

```plaintext
sudo passwd fmadio
```

Example below

```plaintext
fmadio@fmadio20v3-287:/etc$ sudo passwd fmadio
Changing password for fmadio
Enter the new password (minimum of 5, maximum of 8 characters)
Please use a combination of upper and lower case letters and numbers.
New password:
Re-enter new password:
passwd: password changed.
fmadio@fmadio20v3-287:/etc$
```

### Step 2) Make change persistent

The files in /etc/* are not persistent, e.g. they will be lost on system reboot.

To make the update persistent across reboots copy the file per below

```plaintext
sudo cp /etc/shadow /opt/fmadio/etc
```

Example output

```plaintext
fmadio@fmadio100v2-228U:$ sudo cp /etc/shadow  /opt/fmadio/etc        
fmadio@fmadio100v2-228U:$
```

### Step 3) Reboot

Reboot the system to ensure the password update has been made persistent.

### Step 4) Finished