Installing on a Windows XAMPP box about paperwork HOT 15 CLOSED

Quickly:
1 - Git clone
2 - Add to vhost:
2.1 Vhost Document root: frontend/public
3 - On frontend folder:
composer install

Done!

from paperwork.

Hmmmm. I don't Vhost. I have access to the htdocs folder.

So although I thank you very much for answering can I just put the frontend under whatever folder I want and then access it at localhost/folder/frontend/public or what do I need to do?

I'm fine with Codeigniter but I haven't done anything with a Larvel app yet.

from paperwork.

frontend/public = htdocs

So, you need change some things on laravel paths.

from paperwork.

Would you, or anyone else, care to elaborate?

Seriously you have a great app here but you need to be a little clearer on how to get it installed for people who haven't used Laravel.

from paperwork.

Hi @DonLafferty,

you are right with this. Unfortunately, we do not yet have a detailed documentation about how to set up Paperwork, if you're an unexperienced user - especially not on a Windows XAMPP setup.

I'm personally not a windows user myself, but I can tell you how to set it up on Mac (e.g. using MAMP) and on Linux.

First of all, as @rguedes already described, you need to clone this project on your machine. After that, make sure that you have one of the latest PHP versions > 5.1 and an up-to-date "composer" installed. If you're not sure how composer works, please continue reading here: https://getcomposer.org/

Now, you need to switch to the command line: "cd" into the "frontend" directory of your local paperwork clone. There, run "composer install" and/or "composer update". This will install all the needed dependencies.

Now, before you do anything else, please check the files within the frontend/app/config/ directory. Especially the database.php. If you'd like to use the default DB settings (MySQL/MariaDB), you'll just need to have the database server running on port 3306 and create a database named "paperwork". You could use this SQL:

DROP DATABASE IF EXISTS paperwork; CREATE DATABASE IF NOT EXISTS paperwork DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

In addition, you need the "paperwork" user to have full access to this database:

GRANT ALL PRIVILEGES ON paperwork.* TO 'paperwork'@'localhost' IDENTIFIED BY 'paperwork' WITH GRANT OPTION; FLUSH PRIVILEGES;

With these settings, you won't need to modify the database.php configuration file.

After completing these steps, run the migration jobs, that fill the database:

php artisan migrate

If anything here should fail, it's most likely an authentication/connection issue, so check your database setup again.

Now, for the last step, make sure that your Webserver has the right to create/modify/delete files within the frontend/app/storage/attachments/ folder. This folder is being used for uploaded documents.

That's pretty much it. From here on, you should be able to access your paperwork instance through the web.

I hope I could help you at least a bit. Maybe you could contribute a clean & official documentation on how to set up Paperwork the right way on Windows, after you managed it to get it running yourself? :-)

Best regards,
Marius

from paperwork.

Marius,
Thank you for the much better instructions. I will attempt to do this on a XAMPP installation as I see Composer does have a Windows install. I will report back.

from paperwork.

You're welcome. Btw: https://getcomposer.org/doc/00-intro.md#installation-windows

from paperwork.

Using the above instructions I was relatively successful with the exceptions below.

To preface this note that I installed in a Windows XAMPP environment under a folder structure as follows.

xampp/htdocs/twostairs/frontend

I believe this is causing the following issues but because I'm not a Laravel coder I'm not sure how to change the paths.php file to point everything correctly.

1. The images don't show up.

2. When I attempt to create a new notebook the popup appears and I type in my notebook name but clicking on the Create button does nothing. The popup stays there and nothing is created. Clicking Cancel closes the popup.

I will continue to search for instructions on how to move a Laravel application to something that's not the root.

from paperwork.

The path should't be any problem, as the Laravel part begins only underneath /frontend/. Another user struggling with the installation just wrote a how-to for installing Paperwork on CentOS: http://deviantengineer.com/2014/10/paperwork-centos7/ - even though it's not Windows, it might point you into the right direction.

I'm really sorry for not being able to help you with the installation on Windows, as I don't use any Windows-based *AMP infrastructure.

Could you maybe open your browsers JavaScript/Errors console and paste the errors you receive there? This would help troubleshooting.

from paperwork.

These are the kinds of errors I'm getting. Looks like I need to change the path somewhere but as I mentioned I don't know how in Laravel.

GET http://192.168.254.166/images/navbar-logo.png 404 (Not Found) 192.168.254.166/:38
GET http://192.168.254.166/fonts/Lato-Regular.woff jquery.min.js:3581
GET http://192.168.254.166/fonts/Lato-Semibold.woff jquery.min.js:3581
GET http://192.168.254.166/api/v1/i18n 404 (Not Found) angular.min.js:8522
GET http://192.168.254.166/api/v1/notebooks 404 (Not Found) angular.min.js:8522
GET http://192.168.254.166/api/v1/shortcuts 404 (Not Found) angular.min.js:8522
GET http://192.168.254.166/api/v1/tags 404 (Not Found) angular.min.js:8522
GET http://192.168.254.166/api/v1/notebooks 404 (Not Found) angular.min.js:8522
GET http://192.168.254.166/api/v1/shortcuts 404 (Not Found) angular.min.js:8522
GET http://192.168.254.166/api/v1/tags 404 (Not Found) angular.min.js:8522
GET http://192.168.254.166/api/v1/notebooks 404 (Not Found) angular.min.js:8522
GET http://192.168.254.166/api/v1/shortcuts 404 (Not Found) angular.min.js:8522
GET http://192.168.254.166/api/v1/tags 404 (Not Found)

Remember my folder tree looks like xampp/htdocs/twostairs/frontend

from paperwork.

Is your document root set to xampp/htdocs/twostairs/frontend/public/? If not, you need to do that.
Is mod_rewrite enabled? You need that as well.

from paperwork.

If you're talking about in my httpd.conf the answer is no it's set to htdocs.

I can't change it or I wouldn't be able to run multiple codeigniter apps on the same web server. In other words you need to be able to share the server with other apps and not expect to be in the root.

As for mod_rewrite I've not don't anything with that so please explain.

Could I just add a .htaccess that would redirect anything that tried to access the root from twostairs?

from paperwork.

@DonLafferty if you're really going for this "poor" setup, check out the following link: http://driesvints.com/blog/laravel-4-on-a-shared-host

It's really not Paperwork that could do anything to help you here. If you're intending to keep your setup the way it is and want Laravel (the framework around Paperwork) to function like that, you'll need to request them to support it.

Sorry we can't help you here.

from paperwork.

I'm not sure what you're talking about when you say "poor" setup as it seems to me installing on a server using virtual hosts would be much "poorer" than installing on a web server that I own and can put my hands on.

I think the Paperwork folks need to understand that they won't always be able to install into the root of the web server and therefore need to understand how to do it.

I know Laravel can have multiple instances on a single server so I was hoping that you folks knew how to do that since you know a LOT MORE about Laravel than I do.

If I did it the way you are suggesting I would need to run everything as a virtual host but Codeigniter doesn't need that and I'm pretty sure neither does Larave.

from paperwork.

We're kind of talking past each other. I posted you a link on how you can get Laravel (and by that, Paperwork) running on a shared host environment. Additionally, feel free to google for "laravel 4 shared host" on your own, for more information on this topic.

Again: This has nothing to do with Paperwork. Paperwork is built on top of Laravel 4. If you reconfigure this Laravel foundation to work on a shared host (as described in the link above), you will be able to run Paperwork without a hassle.

As this issue is not related to Paperwork anymore, and support went far beyond it, I'm going to lock it now. If you should experience any trouble with Paperwork later on, feel free to open new issues here. If you should still experience problems while getting Laravel to work on your shared host environment, please refer to the Laravel forums and/or open a new issue here: https://github.com/laravel/laravel

from paperwork.