Skip to content

Commit af95015

Browse files
committed
Updated install information
1 parent 1ce99dd commit af95015

File tree

1 file changed

+40
-21
lines changed

1 file changed

+40
-21
lines changed

README.md

+40-21
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,61 @@
11
# FlexForm - Lightweight Form Server
22

3-
## Introduction
4-
53
Welcome to FlexForm, a fully open-source, headless form server designed with simplicity, efficiency, and privacy in mind. Built to be easily installed on any budget-friendly hosting solution or free cloud tiers, FlexForm is the perfect choice for developers and businesses looking for a reliable and GDPR-compliant form management solution.
64

75
<img src="./public/images/screen.png" width="100%">
86

9-
## Features
7+
# Features
108

119
- **Headless Architecture**: FlexForm is built as a headless server, offering flexibility and ease of integration with various frontend systems.
1210
- **Robust Admin Panel**: Manage your forms with ease using our user-friendly admin panel, designed for efficient and intuitive form management.
1311
- **Cost-Effective**: Designed to run smoothly on inexpensive hosting or free cloud services, reducing your operational costs.
1412
- **GDPR Compliant**: We prioritize your data privacy. FlexForm ensures that all your data remains yours, complying fully with GDPR regulations.
1513
- **Open Source**: Dive into the code, customize, and contribute! Our community-driven approach means FlexForm is continually evolving.
1614

17-
## License
15+
# Requirements
16+
### PHP Version
17+
- PHP 8.2 or higher.
18+
19+
### PHP Extensions
20+
- GD
21+
- ZIP
22+
- XML
23+
24+
### Supported Databases
25+
- SQLite
26+
- MySQL
27+
- PostgreSQL
28+
- MariaDB
29+
- AuroraDB
30+
31+
# License
1832

1933
FlexForm is released under MIT, ensuring it remains free and open for use and modification.
2034

21-
## Getting Started
35+
# Getting Started
36+
37+
- [Deploying on cloud hosting](#deploying-on-cloud-hosting)
38+
- [Deploying on shared hosting](#deploying-on-shared-hosting)
39+
- [Running locally with docker](#running-locally-with-docker)
40+
- [Running locally without docker](#running-locally-with-php-server)
41+
- [Deploy instructions](#deploy-instructions)
42+
2243

23-
### How to run locally with docker
24-
Checkout the repository jump to the folder and run the following commands:
44+
## Running locally with docker
45+
Use the latest [image from docker hub](https://hub.docker.com/r/flexform/flexform-server) to run it locally:
2546
```bash
26-
docker-compose up
47+
docker run --name flexform -d -p 9000:9000 flexform/flexform-server:0.1
2748
```
2849
Run DB migrations from container
2950
```bash
51+
docker exec -it flexform bash
3052
php bin/console doctrine:migrations:migrate
3153
```
3254

33-
### How to run locally without docker
55+
## Running locally with PHP server
3456
Make sure you have PHP 8.2 and composer installed.
3557
Checkout the repository jump to the folder.
3658
Copy environment file and adjust it to your needs:
37-
```bash
38-
cp .env.dev .env
39-
```
4059
Install dependencies:
4160
```bash
4261
composer install
@@ -50,16 +69,14 @@ Run the server:
5069
php -S localhost:8000 -t public
5170
```
5271

53-
### How to install on shared hosting
54-
Build the project on your local machine or download prebuild release from [here](https://flexform.nyc3.cdn.digitaloceanspaces.com/flexform-server-latest.zip).
72+
## Deploying on shared hosting
73+
Build the project on your local machine or [download prebuild release](https://flexform.nyc3.cdn.digitaloceanspaces.com/flexform-server-latest.zip).
5574
Upload the files to your shared hosting.
75+
Make sure you make "public" folder as your main folder.
5676

57-
Make sure you:
58-
- Set the environment variable `APP_ENV` to `prod` in your `.env` file. See [.env.prod](.env.prod) for an example.
59-
60-
### Deploy on cloud hosting
77+
## Deploying on cloud hosting
6178
You can deploy FlexForm on any cloud hosting provider that supports PHP 8.2 or higher.
62-
Also you can use our Dockerfile to deploy FlexForm on any cloud hosting provider that supports docker.
79+
Also you can use [FlexForm Docker Image](https://hub.docker.com/r/flexform/flexform-server) to deploy FlexForm on any cloud hosting provider that supports docker.
6380

6481
Make sure you:
6582
- Set the environment variable `APP_ENV` to `prod`
@@ -68,10 +85,12 @@ Make sure you:
6885

6986
You can see an example of environment variables in the [.env.prod](.env.prod) file.
7087

71-
### Deploy instructions
88+
**Please make sure you made /app/var as persistent storage if you use SQLite. If you want to use other database please change DATABASE_URL env variable.**
89+
90+
## Deploy instructions
7291
- [Installing FlexForm on DigitalOcean Apps](https://medium.com/@ashelestov/installing-flexform-on-digitalocean-apps-b3e5b1ba868a)
7392

74-
## Frontend components
93+
# Frontend components
7594
FlexForm is a headless form server. This means that you can use any frontend framework to build your forms.
7695
We provide a set of frontend components that you can use to build your forms.
7796

0 commit comments

Comments
 (0)