Troubleshooting

Common issues and their solutions when using fileup.

Common Issues

Configuration File Not Found

If you see an error about the configuration file not being found, make sure you have created the config file at ~/.config/fileup/config.ini.

See the Configuration page for the required format.

FTP Connection Failed

1. Verify your hostname is correct
2. Check that your username and password are correct
3. Ensure the FTP server is accessible from your network
4. Try connecting with a standard FTP client to verify credentials

SCP Connection Failed

1. Verify the hostname matches an entry in your ~/.ssh/config
2. Ensure your SSH key is properly configured
3. Test the connection manually with ssh hostname
4. Check that the destination folder exists on the server

Permission Denied

1. Verify you have write access to the destination folder
2. Check that the base_folder path in your config is correct
3. Ensure your credentials have proper permissions

Limitations

• Automatic URL-to-clipboard copy currently uses macOS pbcopy
• Clipboard image uploads need a compatible command (e.g. pngpaste on macOS)
• FTP passwords are stored in plain text; use with caution
• SCP implementation requires the ssh and scp commands to be available

Getting Help

If you encounter issues not covered here:

1. Check the GitHub Issues for similar problems
2. Open a new issue with details about your setup and the error message