Proxeus v1.0

September 24, 2019

Proxeus v1.0

IMPORTANT NOTE: To install and run your own instance of Proxeus, please follow the instructions published on and always make sure that you always pull Docker images from the official `proxeus` DockerHub repository and that you are using the latest version.

Almost four years ago, we started out on a vision to make blockchain more accessible and create what the community later dubbed as the “WordPress of blockchain”. Today, we proudly announce that we now have reached an important milestone: we are releasing version 1.0 of the Proxeus software.


Proxeus simplifies the development of document-centered blockchain applications by combining a powerful document automation tool with a series of blockchain functionalities. Prior to this release, we developed several prototypes showing how the framework can be used to incorporate new businesses, issue course certificates, create donation receipts, certify assets, track shipments or make anti-doping processes more secure. The functionality offered by Proxeus 1.0 will allow the community to easily recreate all of these use cases and charge for services using Proxeus tokens on livenet.


The Proxeus software allows you to create a wide range of blockchain use cases by using and combining the following key functionalities:

  • Design document-centered workflow processes by connecting objects on a visual interface;
  • Create custom workflow nodes to perform all kinds of actions and connect with third-party systems;
  • Create forms to collect data;
  • Design templates and apply the data collected by forms to produce one or several documents;
  • Share workflows with third-parties for free or for a fee charged in XES;
  • Make your documents tamper-proof and easily verifiable by registering the file hash in a smart contract together with the Ethereum ID of your Proxeus account as the issuer;
  • Verify registered documents via drag & drop
  • Request signatures and approve or reject documents shared with you;
  • Extend the system capacities and start workflows automatically using the system API


Users can be active on three possible levels:

  • Operator: Platform administrators setting up and operating a Proxeus platform for their own purposes or in order to make it available to a set of users
  • Creator: Users with backend access that can create and modify forms, templates and workflows
  • Consumer: Users with frontend access only, i.e., able to execute workflows available to them and issue corresponding documents


We distinguish between three different application levels:

The Core is the “engine” that provides the essential functionality of any system built on top of the Proxeus technology stack. It comprises an interface (“I/O”) facilitating the connection with external applications (“extensions”) and the integration with third-party systems.

“Extensions” are smaller stand-alone applications that connect with the Core via the I/O layer. They run in combination with the Core but have no integral function that can be used by other extensions. They can be provided by Proxeus and by external contributors. The extensions are installed by Operators additionally to the Core.

“Applications” are implementations of the Core (and of any relevant extensions) that are done with the objective to fulfill the requirements of specific use cases.


To install and run your own instance of Proxeus, follow the instructions published on Always make sure that you always pull Docker images from the official `proxeus` DockerHub repository and that you are using the latest version.

Once you got your own Proxeus platform up and running, head over to the configuration guide in the handbook for the final steps. After completing the power up, you can log in with your newly created root user account. We recommend to always make your first steps by connecting to the Ropsten testnet. It’s up to you if you’d like to deploy your own smart contract following our instructions or if you prefer to use our demo contract.

If that sounds like too much work and you are only interested to give it a quick try, we are running a demo platform connected to the Ropsten testnet, which you can use to get familiar with Proxeus instead of deploying your own instance. Please be aware that the contents are wiped on a regular basis; be sure to check the schedule on the website in order to avoid loosing your work.


Now that you have successfully installed and configured your Proxeus platform, you can start creating your first application. Make sure that you have all the required tools ready and dive right in following our quick start guide.

A minimal workflow comprises one template and a form to gather the data to be inserted into the document. Your workflow will automatically support the blockchain interactions required to register the output documents on Ethereum. All the concepts are explained in our handbook. If you need inspiration, check out some of the use case examples on our website.

Once you’ve built your first workflow, you can set a price (in XES tokens) for it and publish it. You’re ready to launch your first Proxeus platform!


The next step on the roadmap is to incorporate community feedback and release Proxeus as open source software. We are excited to see Proxeus going out into the world — now it’s your turn to test the software and give us feedback! Your contribution can play a key role in the adoption of Proxeus and XES and we can’t wait to discover new community-driven use cases and learn about new angles and ways to use Proxeus, that we may not even have thought about.

Proxeus Association 2020, All Rights Reserved