---
name: "eurephiadm"
section: "7"
platform: "linux"
package: "eurephia"
version: "1.1.1-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/eurephiadm"
---

# eurephiadm(7)

eurephia administration utility

## NAME

eurephiadm - eurephia administration utility

## SYNOPSIS

**eurephiadm** \<command\> \[\\-h\|\\-\\-help\] \[\\-V\|\\-\\-version\] \[\<global options\>\] \[\\-l\|\\-\\-log \<filename\>\] \[\\-L\|\\-\\-log\\-level \<log level\>\] \[\<command arguments\>\]

## DESCRIPTION

**eurephiadm** is a generic command line tool for administering and configuring the eurephia plug-in for OpenVPN.

## COMMANDS

Available commands in **eurephiadm**

- **help** \[\<command\>\]

  This help screen if no arguments are given.  If a command is given, the help screen for that command is provided.

- **logout**

  Logout from an active eurephiadm session.  Most of the operations in eurephiadm requires the user to authenticate him/herself.  The session will then be active for a predefined amount of time, not requiring new authentications.  The user will have to authenticate him/herself again if the session timesout or the **logout** command is used.

- **users** \[\<arguments\>\]

  User management module.  Lists, adds, removes, activates, deactivates and shows user account information for each eurephia user.

- **lastlog**

  Query the eurephia lastlog.  This log contains information about OpenVPN session authenticated via eurephia.

- **attempts** \[\<arguments\>\]

  Show or reset registered failed login attempts registrations.

- **blacklist** \[\<arguments\>\]

  Show, add or delete blacklisted user accounts, certificates or IP addresses.

- **certs** \[\<arguments\>\]

  SSL Certificate management for eurephia authentication.

- **usercerts** \[\<arguments\>\]

  Manages the relations between eurephia user accounts and certificates.  This combination is called a user access, and defines which access level the authenticated eurephia user will have to the network.

- **fwprofiles** \[\<arguments\>\]

  Firewall profile management.  Add, list or delete (iptables) profiles available for eurephia in the operating system.  This feature is only available if eurephiadm was compiled with firewall support.

- **adminaccess** \[\<arguments\>\]

  Manages eurephia user accesses to administration utilities like **eurephiadm**.

- **show-config**

  List all config settings set in the database and in the **~/.eurephia/eurephiadm.cfg** file.

- **show-configfile**

  Similar to the **show-config** command, but lists only the parsed settings in the **~/.eurephia/eurephiadm.cfg** file.

- **config** \[\<arguments\>\]

  Add, delete or show eurephia configuration settings stored in the database.

## FILES

- **~/.eurephia/eurephiadm.cfg**

  Default configuration file which defines the database driver and the needed database parameters.

## CONFIGURATION FILE

The configuration file is a simple key-value based text file, where keys and values are separated by an equal sign ("=").  All text coming after a hash ("#") will be ignored and considered as comments.  The variables eurephiadm uses are:

- **database\_driver**

  Contains a full path to the database driver eurephiadm need to use.

- **database\_params**

  All database arguments the database driver requires must be set here.  See the man page for the corresponding database driver for more information about valid options.

- **log**

  Defines how to log.  If a file name is given, logging will be sent to this log file.  Other valid values are:

-

  **stderr:** or **stdout:**\
   Logging will go directly to stderr or stdout

-

  **syslog:\[local0..local7 \| daemon \| authpriv\]**\
   Logging will be sent to syslog.  The default syslog destination is daemon**.**

- **log\_level**

  **Sets the log verbosity.  Normally the values will be from 0 to 10, where 0 is as little logging as possible and 10 is very verbose.  If eurephiadm or the database driver is compiled with debug logging, values up to 50 will be valid.**

- **username**

  **eurephiadm** will always be asking for a user name when logging into the administration application.  By setting this variable, you will set a default user name eurephiadm will use when logging in and it will only ask for a password directly.

## ENVIRONMENT

- **EUREPHIA\_DIR**

  The **eurephiadm** utility looks for a configuration file by default in **~/.eurephia/eurephiadm.cfg**.  This directory can be overridden by setting the **EUREPHIA\_DIR** environment variable, and eurephiadm will use the **eurephiadm.cfg** file in this directory instead.

## SEE ALSO

[**eurephiadm-users**(7)](/eurephiadm-users/7.md), [**eurephiadm-lastlog**(7)](/eurephiadm-lastlog/7.md), [**eurephiadm-attempts**(7)](/eurephiadm-attempts/7.md), [**eurephiadm-blacklist**(7)](/eurephiadm-blacklist/7.md), [**eurephiadm-certs**(7)](/eurephiadm-certs/7.md), [**eurephiadm-usercerts**(7)](/eurephiadm-usercerts/7.md), [**eurephiadm-fwprofiles**(7)](/eurephiadm-fwprofiles/7.md), [**eurephiadm-adminaccess**(7)](/eurephiadm-adminaccess/7.md), [**eurephiadm-config**(7)](/eurephiadm-config/7.md), [**edb-sqlite**(7)](/edb-sqlite/7.md)

## AUTHOR

Copyright (C) 2008-2012  David Sommerseth \<dazo@users.sourceforge.net\>