Skip to content

Settings

pawelcel edited this page Nov 17, 2026 · 4 revisions

Settings

Everything under the gear icon in the left bar. The list adapts to who is logged in: administrators see every section, other users see only their own (Notifications, Appearance, Language, My projects, Author, Support).

Screenshots come from a demo database with made-up data; your server looks the same, with your own users and projects.

Section Who What it is for
Users admin accounts, project access, who may release items and change catalogs, CAD macro logins
File storage admin where files live, allowed file types, backups, restore, clearing data
Logs admin the server's log, day by day
Numbering admin number prefixes, zero padding, the name in record names, rewinding the sequence
Tags admin every tag in the database, deleting a tag everywhere
Company admin company name and logo for drawing title blocks
Notifications everyone which events reach your bell
Appearance everyone light or dark theme
Language everyone / admin interface language; documentation languages and document labels (admin)
My projects everyone the projects you can open
Author and Support everyone version, licence, repository; buying the author a coffee

Users

Settings → Users

Accounts. "+ Add user" asks for a login, a password (at least 8 characters), a display name, first and last name and an optional e-mail. First and last name are required because they go into the "drawn by" and "approved by" fields of drawing title blocks; an older account without them is marked in yellow until someone fills them in. Each row has:

  • the role — Administrator (everything, every project) or User (only the projects assigned below);
  • the pencil — edit name, e-mail and login;
  • the key — set a new password (it signs the person out of their other sessions and CAD macros);
  • the bin — delete the account. The last administrator can be neither deleted nor demoted, so the server always keeps one.

Project access. Pick a project, then tick the users who should see it. Administrators always see every project.

Releasing items. Off by default. When on, only an administrator can set the "Released" status: an author sends an item for review and someone with the rights releases it. Other users see the Release button greyed out with an explanation, and the server refuses the change from a CAD macro too. Items already released stay released.

Editing catalogs. Off by default. When on, Materials, Processes, Manufacturers and Clients are changed only by an administrator; everyone else still browses them and picks from them when describing items.

Logged-in CAD macros. Every macro login (FreeCAD, SolidWorks, Inventor, the EasyPDM add-ons and companion — also those signed in through the browser, see CAD Integrations) gets its own token, separate from the browser, valid for a year. The list shows which macro, whose it is, when it was last used and when it logged in. The bin signs out only that macro — at its next operation it opens the browser sign-in again (on servers before 0.9: asks for the password). Changing a user's password signs out all of their macros.


File storage

Settings → File storage

Current location / New location. The folder on the server where attachments and CAD files are kept, with how many files and how much space. "Change location" moves it; you choose whether the existing files are moved along or stay where they are.

Allowed file types. With an empty list the server accepts every file, as it always has. Once you add extensions, it accepts only those types, each with its own size limit in MB (empty = no limit) — a CAD assembly can be allowed 1000 MB while a PDF gets 50. A file of any other type, or over its limit, is refused in every place that stores a file: CAD macro uploads, attachments, project and client documents. An oversized upload is stopped before it is written to disk. "Add the types the CAD macros use" fills in what the CAD integrations send (.fcstd, .sldprt, .sldasm, .slddrw, .ipt, .iam, .idw, .dwg, .sc for SolidCraft, .step, .stp, .pdf, .png), and the page warns while one of them is missing, as in the screenshot — a list that forgets .png would quietly break every macro's preview image.

Backup. "Download backup" gives one ZIP with the database and the whole file storage.

Restore from backup. Upload such a ZIP to replace the current database and files. This overwrites everything and cannot be undone. A backup made on another server finds its files in this server's storage location and brings its database up to date on the spot. "Replace files despite database restore errors" is the escape hatch for a partly broken backup.

Automatic backup. Daily, weekly (pick the day) or monthly (pick the day of the month), at a chosen time, keeping the last N backups.

Danger zone. Deletes chosen categories of data for good — the whole database or projects, materials, manufacturers, clients, processes and the company profile — with their files on disk. User accounts and server settings always stay. Meant for starting from a clean slate after testing; download a backup first if in doubt.


Logs

Settings → Logs

The server writes one log file per day. Pick the day, narrow it down with Filter lines, Refresh to see new lines, or Download full file to send it to someone. The first place to look when an upload or a macro does something unexpected.


Numbering

Settings → Numbering

Prefixes. A letter (or a few) put in front of the number of newly created items of each kind — e.g. C for manufactured parts gives C12. Purchased and client assemblies share the prefix of the matching part kind; manufactured assemblies have their own. Changing a prefix never touches existing items: theirs was frozen when they were created, because it is part of their file names.

Zero padding. Pads numbers to a fixed width (0012 instead of 12). Like the prefix, it applies only to items created after the change.

Item name in the record name. On: a record reads number(name), e.g. C0012(Bracket), and that is the name the CAD macros give the file. Off: just C0012, and the name lives only in the item's properties. Again, only for items created afterwards.

Numbering rewind. Sets the number the next item will get — possible only when no existing item has that number or a higher one, typically to reclaim the numbers left by deleted test items. The line above the field shows the next number and the highest one in use.


Tags

Settings → Tags

Every tag used in the database, with how many items carry it. Search them, show all or only the unused ones, and delete a tag — it disappears from every item at once (released ones included), from the suggestions and from the Whole database filter. The confirmation says how many items it is on.


Company

Settings → Company

The company name and logo (PNG or JPEG, up to 2 MB, ideally square on a white or transparent background) that the CAD macros put into the drawing title block. See CAD Integrations → Drawing sheets.


Notifications

Settings → Notifications

Which events reach your bell: items waiting for review, released or sent back to work, new revisions, client verification results, being added to or removed from a project, a project deleted, your password changed by an administrator, the report after a CAD macro run, and — for administrators — low disk space on the file storage. Each one is a switch of its own, per person.


Appearance

Settings → Appearance

Light or dark theme, remembered in this browser.


Language

Settings → Language

Interface language. English, Polish or German for the application itself, remembered in this browser. Everyone chooses their own. (Messages coming from the server are in English whatever you pick.)

The rest of the page is for administrators. It is about the language documentation is written in, which is separate from the interface language — a Polish engineer can work in a Polish interface on a project documented in English.

Default documentation language. The language a new project's documentation is in unless chosen otherwise.

Documentation languages. The languages your company documents in: a full name and a code of 1–3 capital letters (EN, PL, DE, …). English and Polish come built in. A project picks its main language from this list and, if it is multilingual, which other languages it carries; process names and descriptions and item names then get translations in those languages.

Labels in documents. The labels EasyPDM writes into the documents it produces, per documentation language: the column headers of the BOM CSV export and the fields of the drawing title block (Drawn by, Approved by, Drawing number, the processes and revision table headers…). English, Polish and German are built in; an empty field means the built-in label (shown in grey), and any other language starts from English. A document always uses its project's main language.


My projects

Settings → My projects

The projects you have access to. The section is named after you.


Author

Settings → Author

The version running on the server, the licence (MIT) and a link to the repository.

Support

Settings → Support

EasyPDM is free and maintained in spare time; this is where you can buy the author a coffee if it has been useful. Completely optional.

Clone this wiki locally